JSON est un format d'échange de données dont la RFC n'admet pas les

commentaires, qui sont par nature des métadonnées. Un

analyseur syntaxique JSON strict détecte une erreur s'il rencontre un

caractère non prévu par la spécification.

Il existe des initiatives de formats étendant JSON pour ajouter des

commentaires (comme Hjsoncite-ref-6[6] pour Human JSON en anglais) et des

logiciels permettant de restituer, à partir de ces formats dérivés, du

JSON standard. Toutefois, ces fichiers, demandant alors une étape

supplémentaire avant de pouvoir être lus par un interpréteur JSON

standard, perdent légèrement en facilité d'interopérabilité.

On peut toujours ajouter une propriété à un champ dans un tableau

associatif JSON, la nommer "_comment" (un usage qui se développe[Quand

?][réf. nécessaire]), et mettre un texte (le commentaire) dans le champ

valeur :

{

"_comment": "Imported from Wikidata 2015-05-27 10:13.",

"QID": "Q5502001",

"label": "Adèle",

"description": "late 18th century, early 19th century French brig"

}

Durant la mise au point du format, Douglas Crockford constate que

certains des premiers utilisateurs du JSON ajoutent des commentaires

dans le but de donner des directives au parseurcite-ref-crockford-2012-7-0[7], à l'image des

instructions #ifdef ou #define du préprocesseur C. Il y voit un danger

pour l'interopérabilité, une priorité du format, et décide de les

retirercite-ref-crockford-2012-7-1[7]. En 2012, il s'explique sur ce choix et reconnait être

conscient de la tristesse des utilisateurs de ne pouvoir commenter ces

fichierscite-ref-crockford-2012-7-2[7].